//  ------------------------------------------------------------------------ //
//                                  RW-Banner                                //
//                    Copyright (c) 2006 BrInfo                              //
//                     <http://www.brinfo.com.br>                            //
//  ------------------------------------------------------------------------ //
//  This program is free software; you can redistribute it and/or modify     //
//  it under the terms of the GNU General Public License as published by     //
//  the Free Software Foundation; either version 2 of the License, or        //
//  (at your option) any later version.                                      //
//                                                                           //
//  You may not change or alter any portion of this comment or credits       //
//  of supporting developers from this source code or any supporting         //
//  source code which is considered copyrighted (c) material of the          //
//  original comment or credit authors.                                      //
//                                                                           //
//  This program is distributed in the hope that it will be useful,          //
//  but WITHOUT ANY WARRANTY; without even the implied warranty of           //
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the            //
//  GNU General Public License for more details.                             //
//                                                                           //
//  You should have received a copy of the GNU General Public License        //
//  along with this program; if not, write to the Free Software              //
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA //
// ------------------------------------------------------------------------- //
// Author: Rodrigo Pereira Lima (BrInfo - Solues Web)                      //
// Site: http://www.brinfo.com.br                                            //
// Project: RW-Banner                                                        //
// Descrio: Sistema de gerenciamento de mdias publicitrias               //
// ------------------------------------------------------------------------- //

[b]DESCRIO:[/b]
===============================
Mdulo xoops de gerenciamento e exibio de  banners randmicos, que  pode ser usado ou no em conjunto com o sistema de banners padro do xoops.

O objetivo  deste mdulo    propiciar  ao  administrador do site um mtodo organizado, robusto e eficiente para gerenciar mdias e espaos publicitrios em seu site.

[b]CARACTERISTICAS:[/b]
===============================
- Cadastro de Banners.
- Cadastro de Categorias de banners.
- Cadastro de modelos de banners.
- Cadastro de Tags de banners.
- Cadastro de clientes de banners.
- 5 modelos de exibio de banners. Inlcuindo blocos em Ajax.
- Todos os blocos so clonveis.
- Bloco para esttisticas do cliente e seus banners.
- Ativao/desativao de banner com 1(um) clique do mouse.
- Banners inativos podem continuar no banco de dados.
- Criar Tags Smarty para uso em seu tema, mdulos, blocos e contedo.
- Cliente pode verificar a situao de seus banners quando logado no site.
- O cliente poder fazer ajustes em seus banners (se o administrador do site permitir)
- Envia e-mail de comunicao aos clientes sobre esttisticas de seus banners.
- Vrias modalidades de utilizao randmicas.
- Voc poder criar conjuntos de banners intercalados por grupos.
- Aceita e exposio de mais de um banner nos blocos.

[b]FUNCIONALIDADES:[/b]
===============================
- Cadastramento de banners separados  por categorias e clientes, estas  categorias  so usadas para diferenciar os tamanhos dos banners, fazendo assim com que se possa criar diversos modelos de exibio dos banners. Os clientes so os  usurios cadastrados no site, na hora de cadastrar um banner  obrigatrio vincul-lo a um usurio.

- 5 modelos de blocos  para exibio de banners clonveis e com diversas configuraes, deixando a critrio do administrador  do mdulo escolher  quantos  banners randmicos deseja  que seja  exibido, qual a categoria  de banners exibir  e ainda a opo de se criar uma tabela  para a exibio dos banners, bastando selecionar em quantas colunas os mesmos sero exibidos.

- Bloco de Estatsticas do Cliente. Neste bloco  mostrado uma tabela com as principais estatsticas de todos os banners do cliente.

- Opo de ativao e dasativao do banner com apenas um clique. Somente banners ativos sero exibidos, porm os banners inativos continuam na base, possibilitando que os mesmos sejam ativados novamente a qualquer momento.

- Alm dos blocos de exibio de banners, tambm   posvel utilizar o banner randmico no tema do site ou em qualquer pgina que se deseje, bastando  para isso acescentar a varivel smarty <{$rw_banner}> ou qualquer outra que voce desejar criar. No existe  limite  para a sua  criatividade e (esta funcionalidade requer um pequeno hack no core do xoops que ser explicado abaixo no proceso de instalao).

- Pgina de Estatsticas do Cliente. Na pgina principal do mdulo  exibida uma tabela com todas as estatsticas dos banners do cliente logado no site. Ainda nesta  pgina  o cliente tem a opo de enviar as estatsticas do banner para o email cadastrado no site, e caso o o administrador permita, voc mesmo poder alterar algumas informaes do seu banner.

- Exibio de banners randomicos ou no nos textos de outros mdulos. Agora voc poder exibir seus  banners em  qualquer mdulo  que aceite  bbcodes. Voc poder   publicar  banners   em  notcias, artigos, pginas  de   contedo  esttico, inclusive  em posts  de frum. (esta funcionalidade requer um pequeno hack no core do xoops que ser explicado abaixo no proceso de instalao).

[b]INSTALAO:[/b]
===============================
A instalao do mdulo  bem simples pois  igual a qualquer mdulo  padro xoops. Para ativar a funo de exibio de banners randmicos no tema do site voc precisa fazer um pequeno hack no core do xoops, mais especificamente no arquivo header.php, localizado na raiz de seu site.

Para  incluir  o   hack, abra  o  arquivo  XOOPS_ROOT_PATH/header.php  e no  final dele acrescente, antes de } ?>, o cdigo abaixo:

[code]
#######################################################################################
#### Hack by rw-banner
#### Cria variveis smarty para exibir banner no tema do site e nos templates
#######################################################################################
$mod = XoopsModule::getByDirname("rw_banner");
if ($mod){
  include_once (XOOPS_ROOT_PATH.'/modules/rw_banner/include/maketags.php');
}
#######################################################################################
#### Fim do Hack by rw-banner
#######################################################################################
[/code]
Pronto, voc ativou a funo de TAGS SMARTY do mdulo. Na administrao do mdulo voc poder criar, editar, alterar o status e apagar as TAGS. Toda vez que desejar exibir seu banner randmico, seja no tema do site ou nos templates dos mdulos, basta criar uma tag para o modelo de publicidade desejado e coloc-la em seu tema ou template.

Para ativar a nova funo de exibio de banners dentro de textos (em contedos do site) ou seja, dentro de outros  mdulos ou blocos do site, voc precisa incluir um pequeno hack no core do xoops, no arquivo XOOPS_ROOT_PATH/class/module.textsanitizer.php

Para incluir o hack, abra o arquivo XOOPS_ROOT_PATH/class/module.textsanitizer.php e procure pela funo xoopsCodeDecode, no final dela voc dever colocar o cdigo abaixo:
[code]
#######################################################################################
#### Hack by rw-banner
#### Permite a exibio de banners randomicos em qualquer mdulo que aceite bbcodes
#######################################################################################
$mod = XoopsModule::getByDirname("rw_banner");
if ($mod){
  include(XOOPS_ROOT_PATH.'/modules/rw_banner/include/bbcode.php');
}
#######################################################################################
#### Fim do Hack by rw-banner
#######################################################################################
[/code]
Para facilitar o entendimento, dentro da pasta docs do mdulo voc encontrar  a funo xoopsCodeDecode j hackeada, basta seguir o exemplo e aplicar o hack no seu arquivo.

Depois de fazer o hack, para exibir os banners nos seus textos basta  criar  as tags na administrao do mdulo do mesmo jeito que que se cria as tags para exibio no tema do site ou nos templates dos mdulos.

Quando j tiver  suas tags criadas,  basta ir ao mdulo que desejar exibir os banners e no campo de texto  (Tem que aceitar bbcodes!! neste mdulo para funcionar corretamente) inserir a tag da mesma forma que no tema do site por exemplo.

A nica diferena  na sintaxe de declarao da tag.

Veja abaixo os exemplos:

Vamos supor que voc tenha a TAG publicidade criada e configurada na administrao.

Para exibir os banners dessa TAG dentro do seu tema no site voc colocaria:

[b]<{$publicidade}>[/b]

J no corpo das notcias ou em qualquer  texto de  qualquer mdulo  que  aceite  bbcode voc deve colocar a TAG assim:

[b][RW align=center]publicidade[/RW][/b]

O  parametro  align   aceita   os  valores  "left","right" e "center"  respectivamente,  esquerda,  direita e ao centro do local indicado em relao ao contedo mostrado.

[b]ATUALIZAO:[/b]
===============================
O mdulo sofreu uma  modificao  total  em sua estrutura, seja em banco de dados ou em scipts, praticamente foi todo  refeito.  Se voc usa  verses  anteriores  1.3 RC, ns recomendamos firmemente que voc desinstale o mdulo antes de instalar a nova verso.

Caso voc use uma  verso igual ou superior  1.3 RC, apague a pasta do rw_banner e coloque no lugar a pasta da nova verso.

Faa login no site como administrador.

Se voc utiliza o hack no header.php , comente-o primeiro, acesse via browser o endereo "XOOPS_URL/modules/rw_banner/admin/upgrade.php" que o script  far  a  atualizao  das tabelas automaticamente sem que voc perca as configuraes e banners j cadastrados.

Siga os passos do script e seu mdulo estar atualizado.

[b]BUGS AINDA NO SOLUCIONADOS:[/b]
===============================
-Banners em cdigo HTML no tem os cliques contabilizados, essa falha j vem do prprio sistema  de banners  padro do  xoops, funo  esta que  utilizada no mdulo porm com algumas modificaes.

[b]AGRADECIMENTOS:[/b]
===============================
Agradeo a  todos os  amigos da  comunidade  XoopsTotal que  me ajudaram  com  idias e sugestes para o desenvolvimento deste mdulo em especial aos meus amigos Wilson , Giba e EyeKeeper, (conselho do XT) pela grande ajuda, suas  brilhantes  idias e tambm pela participao em todas as etapas de testes do mdulo e tradues.

Para maiores informaes ou resoluo de problemas do mdulo acesse:

http://rwbanner.brinfo.com.br

[b]A SUA DISPOSIO:[/b]
===============================
Estaremos  dentro do possivel  sempre criando  exemplos de  como utilizar o rw_banner e assim voc poder obter o maior proveito possivel a utilizar este mdulo.

Se  voc  estiver  utilizando  este  mdulo, no  deixe de   visitar  o nosso  site  de desenvolvimento para sugerir novidades.

Aproveite  tambm para  preencher o nosso livro  de usurios satisfeitos e mandar o seu recado para que outros usurios que desejarem utilizar este mdulo possam saber que ele funciona e tambm  muito til.

Rw_banner Team Leader.

[b]TheRpLima[/b]
